<?php
///////////////////////////////////////////////////////////////////////////////////////////////////////
//  这个文件是 JCAT PHP框架的一部，该项目和此文件 均遵循 GNU 自由软件协议
// 
//  Copyleft 2008 JeCat.cn(http://team.JeCat.cn)
//
//
//  JCAT PHP框架 的正式全名是：Jellicle Cat PHP Framework。
//  “Jellicle Cat”出自 Andrew Lloyd Webber的音乐剧《猫》（《Prologue:Jellicle Songs for Jellicle Cats》）。
//  JCAT 是一个开源项目，它像音乐剧中的猫一样自由，你可以毫无顾忌地使用JCAT PHP框架。
//  JCAT 由中国团队开发维护，是一个国际性的项目。
//  正在使用的这个版本是：0.3.2 / SVN信息：$Id: class.JCAT_UIObjectParserBase.php 1250 2009-02-07 04:53:17Z aleechou $
//
//
//
//  相关的链接：
//    [主页] http://jcat.JeCat.cn
//    [HTTP下载] http://jcat.JeCat.cn/download
//    [在线文档] http://jcat.JeCat.cn/document
//    [社区] http://jj.jecat.cn/forum-7-1.html
//  不很相关：
//    [MP3] http://www.google.cn/search?q=jellicle+songs+for+jellicle+cats+Andrew+Lloyd+Webber
//    [VCD/DVD] http://www.google.cn/search?q=CAT+Andrew+Lloyd+Webber+video
//
///////////////////////////////////////////////////////////////////////////////////////////////////////
/*-- Project Introduce --*/





/**
 * UI对象分析器的 基类
 *
 * @author		alee
 * @access		public
 */
abstract class JCAT_UIObjectParserBase implements JCAT_IUIObjectParser
{

	/**
	 * 为文本中 与 正则表达式 特殊字符 冲突的字符，添加一个转义斜线
	 *
	 * @access	public
	 * @param	$sTxt	string		等待转义的文本
	 * @static
	 * @return	string
	 */
	static public function EscapeCharacterForRegexp( &$sTxt )
	{
		JCAT_ASSERT::ASSERT_STRING($sTxt) ;
		
		$sTxt = str_replace('/','\\/',$sTxt) ;
		$sTxt = str_replace('\\','\\\\',$sTxt) ;
		$sTxt = str_replace('?','\\?',$sTxt) ;
		$sTxt = str_replace('*','\\*',$sTxt) ;
		$sTxt = str_replace('.','\\.',$sTxt) ;
		$sTxt = str_replace('!','\\!',$sTxt) ;
		$sTxt = str_replace('-','\\-',$sTxt) ;
		$sTxt = str_replace('(','\\(',$sTxt) ;
		$sTxt = str_replace(')','\\)',$sTxt) ;
		$sTxt = str_replace('[','\\[',$sTxt) ;
		$sTxt = str_replace(']','\\]',$sTxt) ;
		$sTxt = str_replace(',','\\,',$sTxt) ;
		$sTxt = str_replace('{','\\{',$sTxt) ;
		$sTxt = str_replace('}','\\}',$sTxt) ;
		$sTxt = str_replace('|','\\|',$sTxt) ;
	
		return $sTxt ;
	}
	



	/**
	 * What's this Method ?
	 * 
	 * @access	public
	 * @param	$aManager	JCAT_IUIObjectProcessorManager	What's this Parameter ?
	 * @return	old_value
	 */
	public function SetCompilerManager( JCAT_IUIObjectProcessorManager $aManager )
	{
		$old_value = $this->aCompilerManager ;
		$this->aCompilerManager = $aManager ;
		return $old_value ;
	}



	/**
	 * 取得编译器管理器
	 * 
	 * @access	public
	 * @return	JCAT_IUIObjectProcessorManager
	 */
	public function GetCompilerManager()
	{
		return $this->aCompilerManager ;
	}



	/**
	 * What's this Method ?
	 * 
	 * @access	public
	 * @return	JCAT_IUIObjectProcessorManager
	 */
	public function CreateCompilerManagerMemento()
	{
		return clone $this->aCompilerManager ;
	}
	
	

	// 属性 ///////////////////////////////////////////////////////////////////////////////

	/**
	 * What's this Attribute ?
	 * 
	 * @access	private
	 * @var		JCAT_IUIObjectProcessorManager
	 */
	private $aCompilerManager ;


}
?>